Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs
Página inicial do Docs
/ /
Instalar
Página inicial do Docs
/
Ferramentas
/
Interface SQL
/
Instalar
Página inicial do Docs
/
Ferramentas
/
Interface SQL
/
Instalar

Conecte sua ferramenta SQL ao MongoDB

Connect your SQL tool, such as Tableau, Power BI, or DBeaver to your MongoDB Atlas or Enterprise Advanced (EA) database.

All three SQL Interface deployment options use the same JDBC and ODBC drivers, so the steps on this page are the same whether you connect to an Atlas dedicated cluster, an Atlas federated database instance, or a self-managed Enterprise Advanced (EA) deployment. Configure your deployment to accept SQL connections first. To learn how, see SQL Interface Server Setup.

Observação

MongoDB officially supports Tableau (Desktop, Server, or Cloud) and Power BI Desktop (Desktop and Service) with its JDBC and ODBC drivers. You can use the JDBC and ODBC drivers with other SQL-92 compatible tools, but MongoDB cannot guarantee compatibility. Test your specific SQL Interface features to confirm support.

Conectar o Tableau

Connect an Atlas dedicated cluster, an Atlas federated database instance, or a self-hosted Enterprise Advanced (EA) database to Tableau (Desktop or Server) using the Tableau Connector for MongoDB.

Pré-requisitos

Procedimento

As etapas a seguir mostram como se conectar ao MongoDB com o Tableau:

1

Baixe o Connector Tableau para MongoDB.

Observação

O Tableau Desktop e o Tableau servidor versão 2025 e posteriores incluem o Connector para MongoDB. Se a sua versão do Tableau já incluir o conector, pule esta etapa. Para usar uma versão diferente da fornecida com o Tableau, conclua esta etapa.

Para o Tableau Desktop, você também pode instalar o conector a partir do Tableau. Pesquise MongoDB SQL interface by MongoDB no Tableau Exchange e clique em Install and restart Tableau.

  1. Download the latest Tableau Connector taco file from the MongoDB download center.

  2. Mova o arquivo taco para o diretório correto do seu sistema operacional:

    • Windows: C:\Users\<user>\Documents\My Tableau Repository\Connectors

    • macOS: ~/Documents/My Tableau Repository/Connectors

    • Linux: /opt/tableau/connectors

Importante

Se você baixar uma nova versão do Tableau Connector for MongoDB, exclua o arquivo taco anterior do seu diretório Connectors para garantir que o Tableau usará a versão mais recente.

2

Obtenha informações de conexão do banco de dados MongoDB .

Selecione a aba do seu tipo de implantação para obter instruções sobre como obter suas informações de conexão:

  1. Acesse seu cluster dedicado do Atlas ou instância do banco de dados federado para seu projeto.

  2. Clique em Connect.

  3. Selecione a opção Atlas SQL Interface.

  4. Selecione a opção Tableau Connector no menu suspenso Select your driver.

  5. Selecione Tableau no menu suspenso.

  6. Selecione o banco de dados ao qual deseja se conectar no menu suspenso Database.

  7. Copie a string de conexão e os parâmetros de conexão.

    Use essas informações para se conectar ao Tableau em uma etapa posterior.

3

Abra o Tableau desktop ou o Tableau servidor.

4

Vá para o menu Connect.

5

Selecione MongoDB SQL Interface by MongoDB.

Um modal de conexão é exibido.

6

Insira suas informações de conexão do banco de dados :

Insira a string de conexão da Interface SQL que você salvou em uma etapa anterior.

7

Selecione seu método de autenticação.

Escolha seu Authentication Mechanism no menu suspenso.

Para obter informações sobre todos os mecanismos de autenticação suportados, consulte Autenticação de interface SQL.

  • Username: Insira seu nome de usuário MongoDB .

  • Password: Insira sua senha do MongoDB .

8

Clique em Sign In.

Configurar o registro do Tableau

Para alterar a configuração de log do driver JDBC do MongoDB JDBC, adicione as propriedades de log ao arquivo mongodb_jdbc.properties. A localização deste arquivo depende da sua plataforma:

Plataforma
Caminho

macOS

~/Documents/My Tableau Repository/Datasources/mongodb_jdbc.properties
~/Documents/My Tableau Prep Repository/Datasources/mongodb_jdbc.properties

Windows

C:\Users\<username>\Documents\My Tableau Repository\Datasources\mongodb_jdbc.properties
C:\Users\<username>\Documents\My Tableau Prep Repository\Datasources\mongodb_jdbc.properties

Tableau servidor (RHEL)

/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/mongodb_jdbc.properties

Copie este arquivo para todos os nós do servidor.

Para configurar o log, adicione as seguintes propriedades ao arquivo:

loglevel=INFO
logdir=<path-to-log-directory>

A propriedade loglevel define o detalhamento dos logs do driver. Ele aceita os seguintes valores, em ordem crescente de detalhamento: OFF, SEVERE, WARNING, INFO, FINE e FINER. O padrão é OFF.

A propriedade logdir define o diretório onde o driver grava arquivos de log. O diretório já deve existir. Se você omitir logdir ou defini-lo como console, o driver gravará logs no console em vez de em um arquivo.

Importante

Em ambientes de produção, comece com o nível de log SEVERE. Aumente o nível apenas quando precisar diagnosticar um problema, pois cada nível adiciona uma grande quantidade de saída. No nível FINER, o driver faz log de cada chamar que recupera dados para cada célula de cada conjunto de resultados.

Para aprender mais sobre arquivos de propriedade no Tableau, consulte a documentação do Tableau.

Conectar o Power BI

Connect an Atlas dedicated cluster, an Atlas federated database instance, or a self-hosted Enterprise Advanced (EA) database to Power BI using the Power BI Connector for MongoDB.

Pré-requisitos

  • O driver ODBC do MongoDB . Para instalar, consulte Configuração do driver da interface SQL. Para usar o Direct Query, você deve instalar a versão 1.2 ou posterior.

  • Power BI Desktop 64 bit. A Microsoft atualiza e lança o Power BI mensalmente, e o Atlas oferece suporte apenas à versão mais recente do Power BI para Desktop.

  • Sistema operacional Windows. Para conhecer as versões do sistema operacional Windows compatíveis com o Power BI Desktop, consulte a documentação da Microsoft.

Procedimento

As etapas a seguir mostram como se conectar ao MongoDB com o Power BI:

1

Baixe o BI Connector para MongoDB.

  1. Baixe o arquivo mais recente do BI Connector pqx no centro de download do MongoDB.

    Observação

    O BI Connector para MongoDB é fornecido com o desktop do Power BI. Se a sua versão do desktop do Power BI já tiver o conector do MongoDB Atlas SQL, pule esta etapa. Para usar uma versão diferente da fornecida com o desktop do Power BI, conclua esta etapa.

  2. Mova o arquivo do conector para o seguinte caminho de diretório:

    C:\Users\<user>\Documents\Power BI Desktop\Custom Connectors.

    Crie a pasta caso ela ainda não exista.

2

Obtenha informações de conexão do banco de dados MongoDB .

Selecione a aba do seu tipo de implantação para obter instruções sobre como obter suas informações de conexão:

  1. Acesse seu cluster dedicado do Atlas ou instância do banco de dados federado para seu projeto.

  2. Clique no botão Connect.

  3. Selecione a opção Atlas SQL Interface.

  4. Selecione a opção Power BI Connector no menu suspenso Select your driver.

  5. Copie a string de conexão

    Use estas informações para se conectar ao Power BI em uma etapa posterior.

3

Conecte-se a partir do desktop do Power BI.

  1. Abra o Power BI Desktop.

  2. Selecione Get data no menu Home.

  3. Encontre e selecione o conector MongoDB Atlas SQL.

    1. Digite mongo na barra de pesquisa para encontrar o novo conector.

    2. Selecione MongoDB Atlas SQL.

    3. Clique em Connect.

  4. Insira o URI e o nome do banco de dados e clique em OK.

    A MongoDB URI é a string de conexão que você copiou em uma etapa anterior.

    No campo Native query, você pode inserir opcionalmente uma query SQL. O Power BI usa a query SQL como fonte direta para os dados. Você também pode adicionar ou alterar a query SQL no editor do Power Query após se conectar.

  5. Insira seu Atlas User name e Password e clique em Connect.

    By default, users can access all namespaces that their roles and connection URI permit. If you use custom roles to restrict access, you can grant users access to additional namespaces in the Edit User menu. To learn more, see Configure Database Users.

    Para obter informações sobre outros mecanismos de autenticação suportados, consulte Autenticação de interface SQL.

Direct Query

Direct Query is a connection mode available with the Power BI Connector for MongoDB version 1.2 and later. To use Direct Query, you must install MongoDB ODBC Driver version 1.2 or later. You don't need to configure a DSN.

O Direct Query é uma alternativa ao modo de importação padrão e permite que você faça uma query no seu banco de dados diretamente. Isso dá garantias de dados atualizados, mas pode levar mais tempo para retornar resultados.

a query direta não suporta algumas ações. Se você tentar executar uma ação sem suporte, o Power BI solicitará que você alterne para o Modo de Importação.

Conecte o DBeaver

Conecte seu cluster dedicado do Atlas , instância do banco de dados federado do Atlas ou sistema Enterprise Advanced (EA) autogerenciado ao DBeaver usando o MongoDB JDBC Driver.

Pré-requisitos

Procedimento

Para se conectar a partir do DBeaver:

1

Obtenha informações de conexão do banco de dados MongoDB .

Selecione a aba do seu tipo de implantação para obter instruções sobre como obter suas informações de conexão:

  1. Acesse seu cluster dedicado do Atlas ou instância do banco de dados federado para seu projeto.

  2. Clique no botão Connect.

  3. Selecione a opção Atlas SQL Interface.

  4. Selecione a opção JDBC Driver no menu suspenso Select your driver.

  5. Selecione o banco de dados ao qual deseja se conectar no menu suspenso Database.

  6. Copie a string de conexão

    Use estas informações para se conectar ao DBeaver em uma etapa posterior.

2

Abra seu aplicativo DBeaver.

3

Adicione um driver ao DBeaver.

  1. No DBeaver, clique em Database e selecione Driver Manager no menu suspenso.

  2. Clique em New para abrir o modal Create new driver.

  3. Na aba Settings, especifique as seguintes informações:

    Nome do driver

    MongoSQL

    Nome da classe

    com.mongodb.jdbc.MongoDriver

  4. Na guia Libraries, clique em Add File e adicione seu arquivo JDBC driver all.jar.

    Clique em Find Class.

  5. Clique em OK. O modal Create new driver fecha.

4

Cria uma conexão do banco de dados.

  1. No DBeaver, clique em Database e selecione New Database Connection no menu suspenso para abrir o modal Connect to a database.

  2. Na lista de bancos de dados, selecione o driver de banco de dados do MongoDB que você criou na etapa anterior.

    Se não vir MongoDB, selecione a categoria All dentro do modal.

    Clique em Next.

  3. Na guia Main, insira as seguintes informações:

    JDBC URL

    String de conexão obtida em uma etapa anterior.

    Nome de usuário

    Usuário MongoDB autorizado para a conexão.

    Senha

    Senha associada ao usuário MongoDB .

  4. Na guia Driver properties, expanda User Properties. Adicione as seguintes propriedades de valor chave:

    database

    O nome do seu banco de dados virtual.

    utilizador

    O usuário do MongoDB com o qual se conectar. Não é obrigatório se você inseriu Username na etapa anterior.

Próximos passos

Depois de conectar sua ferramenta SQL ao seu banco de dados MongoDB, você pode fazer query nos seus dados. Para aprender mais, consulte:

Observação

Para se conectar usando um private endpoints, consulte Conectar à interface SQL do MongoDB com um private endpoints.

Voltar
Configuração do driver
Próximo
Query
Avalie esta página

Nesta página